<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<HEAD>
     <TITLE>Rtc</TITLE>
     <link rel="stylesheet" type="text/css" href="../../../ss/2.css" id="thecss">
     <script type="text/javascript" src="../../../scripts/csschange.js"></script>
</HEAD>

<BODY onload="readSS()">

<br>
<center>
<table border=3 cellpadding=5 cellspacing=0>
<tr>
     <td><h1 class="pagetitle">Rtc (Ruby Text Container)</h1>
         <b><a href="../../../misc/suppkey.htm">Support Key:</a></b> 
         [<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
         [<span class="ns">X1</span>|<b><i class="fs">X1.1</i></b>]
         [<span class="ns">IE</span>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]</td>
     <td><a href="#what">What is it?</a><br>
         <a href="#attrib">Attributes</a><br>
         <a href="#example">Tag Example</a>
     </td>
     <td><a href="#model">Parent/Content Model</a><br>
         <a href="#tips">Tips &amp; Tricks</a><br>
         <a href="#peculiar">Browser Peculiarities</a></td>
</tr>
<tr><td align=center colspan=3>
<font size=2>= <span class="sitetitle">Index DOT Html</span> by <a href="../../../misc/email.htm">Brian Wilson</a> =</font>
</td></tr>
</table>

<font size=2>
     <a href="../../index.html">Main Index</a> |
     <a href="../../tree/htmltree.htm">Element Tree</a> |
     <a href="../../tagindex/a.htm">Element Index</a> |
     <a href="../../supportkey/a.htm">HTML Support History</a></font>
</center>
<hr align="center" width="25%">

<br><br>
<table border=1 cellspacing=0 cellpadding=5>
<tr><td>
<table border=0 cellspacing=0>
<tr>
   <th colspan=3 valign=bottom class="field"><big><u><b
       class="colheaders">&#160;&#160;&#160;Quick Statistics&#160;&#160;&#160;</b></u></big><br></th>
</tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#et">End Tag:</a></b><br></th>
    <td rowspan=7>&nbsp;&nbsp;</td>
    <td><span class="magicword">Required</span></td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#std">Standards Details:</a></b><br></th>
    <td>Support beginning in XHTML 1.1 DTD.</td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#xhtm">XHTML Modules:</a></b><br></th>
    <td>Ruby</td></tr>
<tr><th align=left valign=top><b class="l3heading"><a href="../stats.htm#disp">CSS 'display' Type:</a></b><br></th>
    <td>"<b class="alert">inline</b>"</td></tr>
<tr><th align=left valign=top><b class="l3heading"><a href="../stats.htm#css">CSS Mapping:</a></b><br></th>
    <td>NA</td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#rnd">Default Rendering:</a></b><br></th>
    <td>NA</td></tr>
<tr><th align=left><b class="l3heading"><a href="../stats.htm#w3docs">Official Docs:</a></b><br></th>
    <td><a href="http://www.w3.org/TR/ruby/#rtc">XHTML 1.1: Ruby Module</a></td></tr>
</table>
</td></tr>
</table>

<br>
<a name="what"></a>
<dl>
<dt><big><b class="mainheading">What is it?</b></big>
    <dd>A <a href="ruby.htm">Ruby</a> is part of an annotation pair - a piece of 
        text ("Ruby Text") that is associated with another piece of text known as 
        a "Ruby Base". A common need for such a structure arises in some asian 
        writing systems where a ruby association is used to present helper readings 
        for uncommonly used writing characters. 
        <br><br>

        With a character set as complex as Chinese or Japanese, some characters are used
        rarely and are thus not as easily recognizable by younger children or possibly
        many adults. In Japanese writing, for example, the phonetic Hiragana alphabet 
        is used to pair phonetic 'helper' readings (called Furigana or Yomigana in 
        Japanese) with the Chinese character counterpart.
        <br><br>

        A Ruby text will usually be rendered next to the Base text such that the 
        association between each Base text and Ruby text is clear (often directly 
        above the Base text.) Ruby text is usually also rendered in a smaller font 
        than the Base text to help visually clarify which part is which in the 
        association relationship.
        <br><br>

        The Ruby Text Container (RTC element) is part of the Complex Ruby markup, 
        where as many as two Ruby text annotations (RTC elements) can be bound to 
        a single piece of Base text. The RTC element serves as a container for Ruby 
        Text (RT) elements. Complex Rubies also allow Base text and Ruby 
        text to be broken down further, so that even more detailed associations 
        can be made between them.
        <br><br>

<dt><big><b class="mainheading">Complex Rubies</b></big>
    <dd>Complex rubies can have multiple Base elements, and multiple Ruby Text 
        components. In a Complex Ruby, all of the Base elements (<a href="rb.htm">RB</a>) 
        are enclosed in an <a href="rbc.htm">RBC</a> element (RBC: Ruby Base 
        Container.) For the Ruby Text elements (<a href="rt.htm">RT</a>), these 
        are enclosed in an RTC element (RTC: Ruby Text Container.) A Complex Ruby 
        can have one or two RTC elements which allows for two text associations 
        to be given for any given Base text. Default rendering might render the 
        first RTC group <em>ABOVE</em> the Base text, with the second RTC group 
        possibly rendered <em>BELOW</em> the Base text... but, this rendering is 
        definitely not guaranteed - allowances for alternate writing directions 
        (eg: vertical rather than horizontal) and other criteria can complicate 
        rendering, and CSS properties have already been proposed specifically for 
        Ruby markup in future CSS versions to control these details.
        <br><br>

        The content of the Ruby Base Container (RBC) is, of course, RB elements. 
        Similarly, the content of any Ruby Text Containers (RTC) are RT elements. 
        With Complex Rubies, RT elements have an additional attribute RBSPAN which 
        acts like COLSPAN does for TD and TH elements in tables - it allows a 
        piece of Ruby Text content to be associated with multiple RB base elements.
</dl>


<a name="attrib"></a>
<dl>
<dt><br><big><b class="mainheading">Common Attributes</b></big>
<dt><b class="subheading">%<a href="../attributes/core.htm">Core</a>%</b>
     <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
         [<span class="ns">X1</span>|<b><i class="fs">X1.1</i></b>]
         [<span class="ns">IE</span>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]

<dt><b class="subheading">%<a href="../attributes/accessibility.htm">Accessibility</a>%</b>
    <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>]
        [<span class="ns">X1</span>|<b><i class="fs">X1.1</i></b>]
        [<span class="ns">IE</span>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]

<dt><b class="subheading">%<a href="../attributes/events.htm">Events</a>%</b>
     <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
         [<span class="ns">X1</span>|<b><i class="fs">X1.1</i></b>]
         [<span class="ns">IE</span>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]

<dt><b class="subheading">%<a href="../attributes/language.htm">Language</a>%</b>
     <dd>[<span class="ns">2</span>|<span class="ns">3</span>|<span class="ns">3.2</span>|<span class="ns">4</span>] 
         [<span class="ns">X1</span>|<b><i class="fs">X1.1</i></b>]
         [<span class="ns">IE</span>|<span class="ns">M</span>|<span class="ns">N</span>|<span class="ns">O</span>]
</dl>


<a name="example"></a>
<dl>
<dt><big><b class="mainheading">Example</b></big>
<dt><b class="subheading">Complex Ruby example:</b>
    <dd><div class="example">&lt;<b class="tagname">ruby</b>&gt;<br>
        &lt;<b class="tagname">rbc</b>&gt;<br>
        &#160;&#160;&#160;&lt;<b class="tagname">rb</b>&gt;http://&lt;/<b class="tagname">rb</b>&gt;<br>
        &#160;&#160;&#160;&lt;<b class="tagname">rb</b>&gt;www.blooberry.com&lt;/<b class="tagname">rb</b>&gt;<br>
        &#160;&#160;&#160;&lt;<b class="tagname">rb</b>&gt;/directory/file.htm&lt;/<b class="tagname">rb</b>&gt;<br>        
        &lt;/<b class="tagname">rbc</b>&gt;<br>
        &lt;<b class="tagname">rtc</b>&gt;<br>
        &#160;&#160;&#160;&lt;<b class="tagname">rt</b> <span class="tagattrib">rbspan</span>=&quot;3&quot;&gt;Uniform 
        Resource Locator&lt;/<b class="tagname">rt</b>&gt;<br>
        &lt;/<b class="tagname">rtc</b>&gt;<br>
        &lt;<b class="tagname">rtc</b>&gt;<br>
        &#160;&#160;&#160;&lt;<b class="tagname">rt</b>&gt;Protocol&lt;/<b class="tagname">rt</b>&gt;<br>
        &#160;&#160;&#160;&lt;<b class="tagname">rt</b>&gt;Hostname&lt;/<b class="tagname">rt</b>&gt;<br>
        &#160;&#160;&#160;&lt;<b class="tagname">rt</b>&gt;Path&lt;/<b class="tagname">rt</b>&gt;<br>        
        &lt;/<b class="tagname">rtc</b>&gt;<br>
        &lt;/<b class="tagname">ruby</b>&gt;</div>
</dl>


<a name="model"></a>
<dl>
<dt><big><b class="mainheading">Parent Model</b></big>
    <dd>&lt;<a href="../r/ruby.htm">ruby</a>&gt;
<dt><big><b class="mainheading">Content Model</b></big>
    <dd>&lt;<a href="../r/rt.htm">rt</a>&gt;
</dl>


<a name="tips"></a>
<big><b class="mainheading">Tips &amp; Tricks</b></big>
<ul>
    <li><a href="../../../testing/html/tags/r/rtc-bp1.htm">[Test]</a>
        It is undefined in the specification what should happen if more than two 
        RTC elements exist in a RUBY element.
</ul>

<a name="peculiar"></a>
<big><b class="mainheading">Browser Peculiarities</b></big>
<ul>
    <li>Nothing to report
</ul>


<br>
<a href="../../../misc/copyright.htm">Boring Copyright Stuff...</a>

</BODY>
</HTML>
